home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbll097.zip / PCBCALL.DOC < prev    next >
Text File  |  1992-08-01  |  6KB  |  141 lines
  1.  
  2.                              PCBCALL - version 1
  3.                             =====================
  4.                               By: Larry Schwenk
  5.  
  6.  
  7.  
  8.      If your like me, you hate reading documentation files as much as I
  9.      hate writing them.  So I'm going to get right to the point...
  10.  
  11.  
  12.      What is PCBCALL
  13.      ==============================
  14.  
  15.      This program is designed to work with the PCBoard BBS system.  It
  16.      will help sysops regain control of their CALLER log file.  This
  17.      version of PCBCALL can accomplish this by three methods:
  18.  
  19.      1 - keep only a specified number of lines
  20.  
  21.      2 - keep only a specified number of days
  22.  
  23.      3 - remove any users from the file, ie. since sysops normally enter
  24.          the system multiple times a day, an analysis of the log file
  25.          would be corrupted if the sysop's logs were not removed.
  26.  
  27.          a) - you can also do a conditional deletion.  Just use the 
  28.               @ symbol in front of the name to be deleted.  The system
  29.               will then prompt you every time to see if it IS what you
  30.               want deleted.  The entire line from the log file is displayed
  31.               for your reference.  There is a built in 15 second delay
  32.               so if you don't hit a key within that time, the program will
  33.               assume that your response is NO and the record will not be
  34.               deleted.
  35.  
  36.  
  37.  
  38.      How PCBCALL works
  39.      ==============================
  40.  
  41.      The program must be passed a file name as a command line parameter.
  42.  
  43.      PCBCALL.EXE <file.cfg>
  44.  
  45.      where <file.cfg> is an ASCII file that contains the following:
  46.  
  47.      line 1:  full path and file name to caller log file
  48.      line 2:  full path and file name for the new caller log file
  49.      line 3:  total number of lines to keep
  50.      line 4:  total number of days to keep
  51.      line 5:  the first user name to be removed
  52.      line 6:  the second user name to be removed
  53.      line 7:  ...
  54.  
  55.      The smallest <file.cfg> must contain at least the first three
  56.      lines.
  57.      PCBCALL.DOC                                                 Page 2
  58.      ==================================================================
  59.  
  60.  
  61.      EXAMPLES:
  62.  
  63.      file1.cfg               file2.cfg               file3.cfg
  64.      ------------------      ------------------      ------------------
  65.      c:\pcb\main\caller      c:\pcb\main\caller      c:\pcb\main\caller
  66.      c:\pcb\main\newfile     c:\pcb\main\newfile     c:\pcb\main\newfile
  67.      4000                    0                       0
  68.                              14                      21
  69.                              larry schwenk
  70.                              @john doe
  71.  
  72.      file1.cfg - would remove all but the last 4000 lines of the log
  73.                  file. It will not however split a user's entry, but
  74.                  will rather start the updated log at the point at which
  75.                  they logged off.
  76.  
  77.      file2.cfg - would remove all but the last 14 days of caller activity.  
  78.                  After all the 'old' entries are removed the program will 
  79.                  then remove any log entry made by these two individuals.  
  80.                  They must be spelled EXACTLY, case is not your concern.  
  81.                  There can be up to 30 names listed, but they must start 
  82.                  on line 5 of the config file.  Since the @ symbol is used 
  83.                  in front of the second name the program will prompt you 
  84.                  for every entry found by "john doe".
  85.  
  86.      file3.cfg - would remove all but the last 21 days of activity.
  87.  
  88.      If both a total number of lines to keep and a keep total number of
  89.      days is specified in the config file, ONLY the lines option will be
  90.      executed, the days will be ignored, however any names that follow
  91.      will still be removed if present.
  92.  
  93.      If names are to be removed it will be the final process to be
  94.      performed.
  95.  
  96.      If you want to keep just a total number of lines, but still remove
  97.      a couple of users AND want the users removed FIRST before the file
  98.      is cut 'down to size' then you can simply run the program twice
  99.      with two different config files.  The first with lines and days set
  100.      to 0 and the names listed, and the second file with just the lines
  101.      option.
  102.  
  103.      You may have line 2 exactly the same as line 1, which will simply
  104.      replace the old caller file.  However, this may cause some problems
  105.      with people using SHARE.EXE and having more than one node.
  106.      PCBCALL.DOC                                                 Page 3
  107.      ==================================================================
  108.  
  109.  
  110.      Author Support
  111.      ==============================
  112.  
  113.      You may have already noticed that there are no SHAREWARE notices
  114.      all over the place.  That is because I'm releasing this version of
  115.      the program as FREEWARE.  All I ask is that you let me know what
  116.      you think of it and offer your suggestions for future improvements. 
  117.      All updates to PCBCALL will be available on Salt Air BBS.
  118.  
  119.      If you have a problem there are several ways to contact me:
  120.  
  121.      Desert Highlands BBS  (816) 429-6245  HST/DS 16.8
  122.      Salt Air BBS
  123.      INTELEC Network (PCBoard conference)
  124.      CompuServe 71270,2053
  125.  
  126.      All written correspondence should be mailed to:
  127.  
  128.                        Larry Schwenk
  129.                        182 SE 411
  130.                        Warrensburg, MO 64093
  131.  
  132.  
  133.  
  134.      Legal Stuff
  135.      ==============================
  136.  
  137.      I've tested this program over and over again.  I have not found any
  138.      problems with it, but that does not mean that it is error free.  So
  139.      you are to use this program at your own risk.  As I can not be held
  140.      responsible for anything that might go wrong.
  141.